home *** CD-ROM | disk | FTP | other *** search
/ Pratica Internet - O Melhor Para Web Design / Pratica Internet: O Melhor Para Web Design.iso / Software / Home Improvement / Coolmap.exe / README.TXT < prev    next >
Text File  |  1996-10-09  |  11KB  |  235 lines
  1. *****************************************************************
  2. *                                                               *
  3. *                           CoolMap(F1.6)                       *
  4. *                                                               *
  5. *                         Written by Mark Qian                  *
  6. *                                                               *
  7. *****************************************************************
  8.  
  9.  
  10.  
  11.  
  12. ***FREE***FREE***FREE***FREE***FREE***FREE***FREE
  13.  
  14. This software is FREE!!
  15. Feel FREE to share with(pass to) your friends 
  16. and clients, upload to your favorite BBS,
  17. On-line systems, FTP sites, or collect it 
  18. into any CD-ROMs!!
  19.  
  20.    
  21.  
  22.  
  23. CoolMap is a Java applet which works as an image map.
  24. It is COOL because it not only works as an image map
  25. but also comes with a built-in design center which 
  26. makes image map design and maintenance visible: CoolMap
  27. can generate a HTML script which calls itself!  A 
  28. sound will also be played when mouse is moved over
  29. a particular hot area.  The corresponding URL will
  30. be opened when clicking at a hot area. 
  31.  
  32. New features are just added: background can be specified to use a transparent map!!
  33.  
  34.  
  35.  
  36. Parameters:
  37.  
  38.  
  39.    mode -           There are two values:
  40.                     design - You can design you image map in this mode.  After clicking at 
  41.                              "Generate HTML Script"button when you finish your design, you 
  42.                              can get the ready-to-plug-in HTML script in "HTML Scropt" field
  43.                              at the bottom of Coolmap Design Center.  Copy and Paste it to 
  44.                              your page.
  45.                     map =    This is the regular mode when the map is pluged in to your page.
  46.                              The mode in HTML script generated by Coolmap Design Center will 
  47.                              be set to "map".
  48.  
  49.   whichBase -       0 the applet uses DocumentBase.  That is, applet will search resouces from
  50.                              the directory where HTML file resides
  51.                     1 applet uses CodeBase.  That is, applet will search resouces from
  52.                              the directory where Java class files resides.
  53.  
  54.   
  55.   mode -           There are two values:
  56.                     design - You can design you image map in this mode.  After clicking at 
  57.                              "Generate HTML Script"button when you finish your design, you 
  58.                              can get the ready-to-plug-in HTML script in "HTML Scropt" field
  59.                              at the bottom of Coolmap Design Center.  Copy and Paste it to 
  60.                              your page.
  61.                     map =    This is the regular mode when the map is pluged in to your page.
  62.                              The mode in HTML script generated by Coolmap Design Center will 
  63.                              be set to "map
  64.  
  65.   
  66.   whichBase -       0 the applet uses DocumentBase.  That is, applet will search resouces from
  67.                              the directory where HTML file resides
  68.                     1 applet uses CodeBase.  That is, applet will search resouces from
  69.                              the directory where Java class files resides.
  70.  
  71.   background   - URL of the Image which is used to paint caption area's background.
  72.                     This URL has to be a local one such as "images/brnpapr.gif".
  73.                     You can not use a URL that point to an address that is not in
  74.                     the server where the applet resides. If parameter background
  75.                     is valid, bgcolor will be ignored.
  76.                     NOTE: Using an image as background will slow down the
  77.                     scrolling speed dramatically.  I may want to adjust the speed
  78.                     to speed up the scrolling text. Or you can ignore parameter
  79.                     background so that the applet use parameter bgcolor in order
  80.                     to increase the srolling speed.
  81.  
  82.                     Why to use an image for background?
  83.  
  84.                     You may usually want to cover the entire applet area with the map.
  85.                     But in some case such as using CoolMap as a toolbar, you may want 
  86.                     have more space to your tooltips while the toolbar image is relatively
  87.                     small.  If you add some blank space to the toolbar image to make 
  88.                     it cover a larger area so that your tooltips can be displayed properly,
  89.                     it will take a large amount of time for the browser to load the large
  90.                     image.  Instead, if you use exactly space requiesd by toolbar but set
  91.                     appletWidth and appletHeight large enough to hold your tooltips.
  92.                     The area that is not covered my toolbar image will be covered with 
  93.                     the background image which is the same as the background on the page.
  94.  
  95.                     Another reason to use background image is that you can make use of
  96.                     transparent gif if you like to have map image transparent. You can
  97.                     use image editor like GIF Construction Set for Windows 
  98.                     (http://www.mindworkshop.com/alchemy/gifcon.html")
  99.                     to create transparent gif used as your map image or toolbar image.
  100.                     You need to set the backgound parameter to the same as the background
  101.                     on the page where Coolmap resides.
  102.  
  103.  
  104.                                          
  105.   bgcolor      - Color of caption background. This feature can be overrided by 
  106.                     parameter background(That is, if background presents, bgcolor
  107.                     will not effect. You need to use the same code format like you use
  108.                     in HTML script such as #ff00ff.  You can also set fgcolor = "vary".
  109.                     Value "vary" will give caption background a random color each time
  110.                     the applet is called.
  111.  
  112.                
  113.   imageWidth -      The width of your image which is used as the map. If the size you specify
  114.                     is different from the actual size of the image, the result will be a stetch
  115.                     one.
  116.   
  117.   imageHeigth -     The heigth of your image which is used as the map.
  118.  
  119.   imageLeft   -     the horizontal position of top-left conner of them map image. In other word,
  120.                     horizontal distance in term number of pixels from the top-left conner of the
  121.                     applet area    to top-left conner of them map image. 
  122.  
  123.   imageTop    -     the vertical position of top-left conner of them map image. In other word,
  124.                     vertical distance in term number of pixels from the top-left conner of the 
  125.                     applet area to top-left conner of them map image. 
  126.  
  127.   appletWidth -     width of applet in design mode.  Important: this pair of parameters will appear
  128.                     as Width and Height in HTML code which calls Coolmap (the Code generated
  129.                     by Coolmap). That is, this is the place where is specify the size of Coolmap.
  130.  
  131.   appletHeigth      height of applet in design mode.
  132.  
  133.  
  134.   deskArrange  - The arrangement of applet and design panel.  It can be "LeftRight" or TopBottom"(default).
  135.                     Note: if the space you specify is not enough for "LeftRight", it will be set to
  136.                     "TopBottom".
  137.  
  138.  
  139.  
  140.   hotStyle          0 - Coolmap will not show the border of a hotware when mouse cursor 
  141.                     is over the hotarea.
  142.                     1 - Coolmap will show a frashing border of a hotware when mouse cursor 
  143.                         is over the hotarea.
  144.   tipsOn            0 - Disable tooltips.
  145.                     1 - Enable tooltips.
  146.  
  147.   imageWidth -      The width of your image which is used as the map.
  148.   
  149.   imageHeigth -     The heigth of your image which is used as the map.
  150.   
  151.   hintWidth -       The width of tool tips window.
  152.  
  153.   fontHeight -      The heigth of tool tips window.
  154.                                         
  155.   mapImage -        File name of the image which is used as the map.
  156.  
  157.   hot_area1 -       The infor about hot area 1 
  158.   hot_area1 -       The infor about hot area 2
  159.   ...
  160.   hot_arean -       The infor about hot area n
  161.  
  162. New feature:
  163.                     The fifth field of hot_arean work the same as
  164.                     parameter "TARGET" in HTML. This field is named
  165.                     Target Window in Design Center.
  166.  
  167.                     You can set it to a sub frame if you use frames so
  168.                     that the URL is opened in the sub frame.  You can 
  169.                     also set it to one of following
  170.  
  171.                       _top 
  172.                        Bowser will place URL page into top-level window of the browser
  173.  
  174.                       _parent 
  175.                        Bowser will place URL page into parent window of the widnow
  176.                        where HTML resides
  177.  
  178.                       _self 
  179.                        Bowser will place URL page into the widnow where HTML resides
  180.  
  181.                       _blank 
  182.                        Bowser will place URL page into a new window
  183.  
  184.  
  185.  
  186.   The sound played by this applet can be turn On/Off dynamically button another
  187.   applet wrtten by Mark Qian, CButton. 
  188.  
  189.  
  190. To place it into your page for FREE, you need to
  191.   
  192.   
  193.   A). Run setup.exe to rename class files.  Because 
  194.       PKUNZIP will extract the  class file, coolmap.class, 
  195.       to coolmap.CLA,  you have to RENAME the class file to 
  196.       coolmap.class.  Similarly, rename the rest
  197.       of *.CLA to *.class.  Then place coolmap.class 
  198.       in the place you want. 
  199.      
  200.       NOTE: ALL THE NAMES OF CLASS HAS TO BE IN LOWER CASE.
  201.             THEY ARE CASE SENSITIVE!!
  202.  
  203.   B). Open TEST_CM.HTM with your browser locally.
  204.       
  205.      
  206.   C). Design your own image map
  207.   
  208.    To use CoolMap's Design Center to generate HTML script which calls CoolMap for you with your hot areas,
  209.    you need to
  210.  
  211.     1).  Set parameter mode in you HTML script that call CoolMap to Design. Then run the script with a browser
  212.          (You have done this).
  213.     2).  Select the Edit mode in Mode section.
  214.     3).  Point your mouse cursor to a point where you like to use as the first point of the hot area. Press left
  215.          mouse button and drag to the second point. Then release mouse button.
  216.     4).  Click at next point.
  217.     5).  Repeat step 4 until you finished all the points which limit the hot area.
  218.     6).  Edit content of tooltips.
  219.     7).  Edit URL address. This URL will be opened when the hot area is clicked.
  220.     8).  Select an audio file for the hot area.  This audio file will be played when mouse cursor moves over the hot area.
  221.     9).  Click at button label 'Click When Done Edit'.
  222.     10). Click at button label 'Generate HTML Script'.
  223.     11). Select the content in the text area at the bottom label 'HTML Script' using mouse
  224.     12). Select Edit and Copy from the pull-down manu of broser to copy the HTML script to clipboard.
  225.     13). Paste the content of clipboard to an empty text file named, say test.htm.  Then browse test.htm with your browser.
  226.          If you see what you want, insert the HTML script to your page.
  227.  
  228.          Done!!  Easy and quickly done!!";  
  229.  
  230.   
  231.     
  232. Go Mark's Home Page(http://www.coolshare.com) to see more exciting applets!
  233.  
  234.  
  235.